table.MARK_DUPS2 Function

Syntax

V Mark_Dups2(C Dup_Key_Expression,C Filter_Expression)

Arguments

Dup_Key_Expression

A field or a combination of fields that Alpha Anywhere uses to determine which records in the table are considered duplicates.

Filter_Expression

Optional. Default = .T. (all records). A character filter expression that specifies which records to check for duplicates.

Description

Marks the duplicate records in the table, including the original record.

Discussion

The <TBL>.MARK_DUPS2() method is a high-level utility method you use to mark duplicate records in a table. The operation is performed on the records in the table pointed to by the object pointer, <TBL>. Note : The difference between this function and <TBL>.MARK_DUPS() is that the <TBL>.MARK_DUPS2() method marks the first record and all its duplicates. You would not want to use this function to select records to delete, since none of the duplicates would remain. A Duplicate_Key_Expression is a field or a combination of fields that Alpha Anywhere uses to determine which records in the table are considered duplicates. For example, if you consider a record with the same values in the Firstname, Lastname and Address1 fields to be a duplicate, the Duplicate Key Expression would be: Firstname + Lastname + Address1. In order to mark a subset of duplicate records, you can add a filter expression to the script. Only records that satisfy the filter are checked for duplicates. If no Filter is specified, then all records are checked for duplicates, regardless of any query that might currently be applied to <TBL>. Note : If you are marking records in a set with one-many child links off the parent table in which you are marking records, remember that if referential integrity is enabled, marking a parent record will result in all matching child records being marked as well. <TBL>.MARK_DUPS() selected records in the top picture and <TBL>.MARK_DUPS2()selected the records in the bottom picture. In both cases the query was against the AlphaSports customer table, looking for records where the Firstname field contained the value "James".

images/XB_Mark_Duplicates.gif

Example

This script marks all records in the current table that have the same PROD_ID field.

dim tbl as P
tbl = table.current()
tbl.mark_dups("PROD_ID")

This script marks all records with PRICE > 100 in the current table that have the same PROD_ID field.

dim tbl as P
tbl = table.current()
tbl.mark_dups("PROD_ID","PRICE > 100")

See Also